在經歷了登入、註冊、介面設計與地圖整合後，我們的行程管家，終於要迎來最關鍵的一步 —— 智慧對話小助手正式啟動！ 🤖✨
今天的重點，是要讓前端的輸入訊息能夠真正「被理解」，
後端的行程管家能根據使用者需求，主動提供「地點介紹」、「附近景點」或「路線規劃」，
讓整個對話體驗宛如和真人旅遊助理對談一樣自然。
Step 1. 建立核心入口：/chat API
在後端中，我們新增 /chat 這個主控端點。
它的任務是統一處理所有訊息，判斷使用者的意圖，並分流到對應的功能模組。
Step 2. 行程管家三大核心功能整合
① 智慧定位 — handle_location_query()
利用 Google Geocoding API 將城市名稱轉成經緯度
呼叫 itinerary_root_agent 自動產生地點介紹與推薦行程
若查無資料，則友善提示重新輸入
📍 範例輸入：
「我想知道台中在哪裡」
📍 範例輸出：
「台中位於台灣中部，是一座融合自然與人文的城市...」
② 附近景點推薦 — handle_nearby_places()
串接 Google Places API 搜尋周圍 5000 公尺內的景點與美食
支援「餐廳」、「景點」、「住宿」等多類別
自動記憶使用者上一次查詢的城市與座標
呼叫 itinerary_root_agent 生成自然語言回覆
📍 範例輸入：
「台中附近有什麼好玩的地方？」
📍 範例輸出：
「在台中高美濕地周邊，有以下熱門景點：高美濕地風景區、望高寮夜景平台...」
③ 智慧路線規劃 — handle_directions()
串接 Google Directions API
若使用者未提供起點，會自動使用上次查詢的地點
自動生成：
距離與時間
分步導航建議（前五步）
旅遊小提醒
📍 範例輸入：
「從台中火車站到逢甲夜市怎麼走？」
📍 範例輸出：
「從台中火車站開車前往逢甲夜市約需 20 分鐘，沿中港路直行即可抵達。」
Step 3. chat_agent() — 行程管家的智慧橋樑
這個函式就像行程管家的「語言翻譯員」，
負責將每個功能處理後的資料，傳遞給 chat_agent，
並統一轉換成自然語言回覆。
它會：
建立對話 Session
打包回覆成 types.Part
非同步呼叫代理執行
收集 AI 文字並返回結果
這也是整個 AI 智慧旅遊邏輯的靈魂所在。
@router.post("/chat")
async def itinerary_chat(message: str, user_context: dict = None):
"""
智能聊天端點 - 根據使用者訊息判斷意圖並呼叫對應的 agent
參數:
message: 使用者的訊息
user_context: 使用者的上下文資訊（如當前位置、上一次查詢的城市等）
"""
# 如果沒有提供 user_context，初始化為空字典
if user_context is None:
user_context = {}
# 分類使用者意圖
intent_data = IntentClassifier.classify_intent(message)
intent = intent_data["intent"]
print(f"偵測到的意圖: {intent}")
print(f"意圖資料: {intent_data}")
# 根據意圖呼叫對應的處理函數
if intent == "location_query":
return await handle_location_query(intent_data)
elif intent == "nearby_places":
return await handle_nearby_places(intent_data, user_context)
elif intent == "directions":
return await handle_directions(intent_data, user_context)
elif intent == "general_chat":
return await handle_general_chat(intent_data)
else:
return {"response": "抱歉，我不太理解您的意思，能再說明一下嗎？"}
async def handle_location_query(intent_data: dict) -> dict:
"""處理地點查詢意圖"""
city = intent_data["city"]
# 使用 Google Maps Geocoding API 取得經緯度
url = f"https://maps.googleapis.com/maps/api/geocode/json?address={city}&key={GOOGLE_MAPS_API_KEY}"
response = requests.get(url)
data = response.json()
if data['status'] == 'OK':
location = data['results'][0]['geometry']['location']
lat = location['lat']
lng = location['lng']
# 呼叫 itinerary_root_agent
query = f"使用者想了解 {city} 的旅遊資訊。原始訊息: {intent_data['message']}"
parts = [
types.Part(text=query),
types.Part(text=json.dumps({
"city": city,
"latitude": lat,
"longitude": lng,
"intent": "location_query"
}))
]
ai_response = await call_agent(parts, "location_query")
return {
"intent": "location_query",
"city": city,
"latitude": lat,
"longitude": lng,
"response": ai_response,
"context": {
"last_city": city,
"last_lat": lat,
"last_lng": lng
}
}
else:
return {
"intent": "location_query",
"response": f"抱歉，我找不到 {city} 的地理位置資訊。",
"error": "無法取得地理位置"
}
async def handle_nearby_places(intent_data: dict, user_context: dict) -> dict:
"""處理附近景點查詢意圖"""
place_type = intent_data["place_type"]
place_name = intent_data["place_name"]
# 從 user_context 中取得經緯度
lat = user_context.get("last_lat")
lng = user_context.get("last_lng")
if not lat or not lng:
return {
"intent": "nearby_places",
"response": "請先告訴我您想在哪個城市尋找附近的地點，例如：「台中有什麼好玩的地方」",
"needs_location": True
}
# 使用 Google Maps Places API 取得附近景點
url = f"https://maps.googleapis.com/maps/api/place/nearbysearch/json?location={lat},{lng}&radius=5000&type={place_type}&key={GOOGLE_MAPS_API_KEY}"
response = requests.get(url)
data = response.json()
if data['status'] == 'OK':
places = []
for place in data['results'][:5]: # 只取前5個結果
places.append({
"name": place['name'],
"address": place.get('vicinity', '無地址資訊'),
"rating": place.get('rating', '無評分資訊')
})
# 呼叫 itinerary_root_agent
query = f"使用者想找經緯度 ({lat}, {lng}) 附近的{place_name}。原始訊息: {intent_data['message']}"
parts = [
types.Part(text=query),
types.Part(text=json.dumps({
"latitude": lat,
"longitude": lng,
"place_type": place_type,
"places": places,
"intent": "nearby_places"
}))
]
ai_response = await call_agent(parts, "nearby_places")
return {
"intent": "nearby_places",
"places": places,
"response": ai_response,
"context": user_context
}
else:
return {
"intent": "nearby_places",
"response": f"抱歉，我找不到附近的{place_name}。",
"error": "無法取得附近景點"
}
async def handle_directions(intent_data: dict, user_context: dict) -> dict:
"""處理路線規劃意圖"""
origin = intent_data.get("origin")
destination = intent_data["destination"]
# 如果沒有起點，使用上次查詢的位置
if not origin and user_context.get("last_city"):
origin = user_context["last_city"]
if not origin:
return {
"intent": "directions",
"response": "請告訴我您的出發地點，例如：「從台中火車站到逢甲夜市怎麼去」",
"needs_origin": True
}
# 使用 Google Maps Directions API 取得路線規劃
url = f"https://maps.googleapis.com/maps/api/directions/json?origin={origin}&destination={destination}&key={GOOGLE_MAPS_API_KEY}"
response = requests.get(url)
data = response.json()
if data['status'] == 'OK':
route = data['routes'][0]['legs'][0]
directions = {
"start_address": route['start_address'],
"end_address": route['end_address'],
"distance": route['distance']['text'],
"duration": route['duration']['text'],
"steps": []
}
for step in route['steps'][:5]: # 只取前5個步驟
directions['steps'].append({
"instruction": step['html_instructions'],
"distance": step['distance']['text'],
"duration": step['duration']['text']
})
# 呼叫 itinerary_root_agent
query = f"使用者想知道從 {origin} 到 {destination} 的路線。原始訊息: {intent_data['message']}"
parts = [
types.Part(text=query),
types.Part(text=json.dumps({
"origin": origin,
"destination": destination,
"directions": directions,
"intent": "directions"
}))
]
ai_response = await call_agent(parts, "directions")
return {
"intent": "directions",
"directions": directions,
"response": ai_response,
"context": user_context
}
else:
return {
"intent": "directions",
"response": f"抱歉，我找不到從 {origin} 到 {destination} 的路線。",
"error": "無法取得路線資訊"
}
async def handle_general_chat(intent_data: dict) -> dict:
"""處理一般聊天意圖"""
message = intent_data["message"]
# 呼叫 itinerary_root_agent 進行一般對話
query = f"使用者的一般問題: {message}"
parts = [
types.Part(text=query),
types.Part(text=json.dumps({
"intent": "general_chat",
"message": message
}))
]
ai_response = await call_agent(parts, "general_chat")
return {
"intent": "general_chat",
"response": ai_response
}
async def call_agent(parts: list) -> str:
"""呼叫 Agent 並取得回應"""
try:
runner = Runner(
app_name="itinerary_housekeeper",
agent=itinerary_root_agent,
artifact_service=artifacts_service,
session_service=session_service,
)
session = await session_service.create_session(
state={},
app_name="itinerary_housekeeper",
user_id="user"
)
content = types.Content(role="user", parts=parts)
# 執行 Agent
events_async = runner.run_async(
session_id=session.id,
user_id="user",
new_message=content
)
response = []
async for event in events_async:
if event.content:
for part in event.content.parts:
if part.text:
response.append(part.text)
result = "\n".join(response)
return result if result else "抱歉，我暫時無法回答這個問題。"
except Exception as e:
print(f"Agent 呼叫錯誤: {str(e)}")
return "抱歉，系統發生錯誤，請稍後再試。"
Step 4. Prompt 設計亮點
🌍 定位 Prompt — GEOCODE_AGENT_INSTRUCTION
將城市名稱轉為經緯度
自動判斷「查城市」或「查食衣住行」
JSON 結構 + 中文解說雙輸出
🗺️ 路線規劃 Prompt — DESTINATION_AGENT_INSTRUCTION
同時產生三條旅遊建議（最佳、極佳、次佳）
整合食衣住行資訊與導航步驟
附上簡短旅遊提醒
這些精心設計的 Prompt 讓行程管家不只是「能回答」，
更能「像人一樣說話」，甚至主動提出貼心建議 💡。
這邊定位、路線規劃、景點推薦的這三個的Prompt的提示詞有做修改
定位位置Prompt
GEOCODE_AGENT_DESCRIPTION = """
行程管家的智慧定位代理，用於將使用者輸入的地址或需求轉換為地理座標（經度與緯度）。
同時支援「食、衣、住、行」等生活與旅遊場景，方便進行地圖定位與路線規劃。
核心功能：
- 接收使用者輸入的文字地址或需求（食、衣、住、行）
- 呼叫地理編碼與地點搜尋服務，轉換為經緯度
- 回傳標準化的座標與分類資訊
- 提供該地點的旅遊建議與景點推薦
"""
GEOCODE_AGENT_INSTRUCTION = """
你是一個行程管家的智慧定位助手。
請使用者提供一個地址或需求（食、衣、住、行），並將其轉換為對應的地理座標。
## 任務規則
1. 若使用者輸入「地址或城市名稱」：
- 識別城市名稱（如：台北、台中、高雄、台南等）
- 查詢並回傳該地址的經緯度
- 提供該城市的特色和旅遊亮點
- 推薦 3-5 個必訪景點
- 給出行程建議（建議停留天數、最佳旅遊季節等）
2. 若使用者輸入「食、衣、住、行」需求：
- 食：搜尋餐廳、美食地點並提供座標
- 衣：搜尋商場、服飾店並提供座標
- 住：搜尋飯店、住宿地點並提供座標
- 行：搜尋交通方式（捷運、公車站、計程車、租車點）並提供座標
3. 結果分兩部分輸出：
**Part 1: JSON 格式**
{
"category": "城市查詢 / 食 / 衣 / 住 / 行 / 地址",
"query": "輸入的原始需求或地址",
"place_name": "地點名稱或城市名稱"
}
**Part 2: 繁體中文建議**（僅在城市查詢時輸出）
城市介紹 + 推薦景點 + 行程建議
## 範例 1：城市查詢
使用者：「台中有什麼好玩的？」
輸出：
{
"category": "城市查詢",
"query": "台中有什麼好玩的",
"place_name": "台中市"
}
台中是個充滿活力的城市，融合了傳統與現代。以下是我為您推薦的景點：
✨ 必訪景點：
1. 國家歌劇院 - 世界級建築傑作，可欣賞建築之美
2. 逢甲夜市 - 台灣最大夜市之一，美食天堂
3. 高美濕地 - 絕美夕陽景觀，攝影愛好者必訪
4. 宮原眼科 - 百年建築改建，必吃冰淇淋
5. 彩虹眷村 - 色彩繽紛的彩繪村落
🗓️ 建議停留：2-3 天
🌤️ 最佳季節：秋冬季節（10月-3月）氣候宜人
需要我幫您規劃詳細路線或搜尋附近的餐廳住宿嗎？
## 範例 2：食的需求
使用者：「我想找台中的美食」
輸出：
{
"category": "食",
"query": "我想找台中的美食",
"place_name": "台中美食區域"
}
## 範例 3：住的需求
使用者：「台北有什麼好的飯店」
輸出：
{
"category": "住",
"query": "台北有什麼好的飯店",
"place_name": "台北住宿區域"
}
## 錯誤處理
若查詢失敗或無法定位，請回覆：
「我無法找到符合的地點，請提供更明確的資訊。例如：具體的城市名稱、地址或您想查詢的類別（食、衣、住、行）。」
## 輸出規則
- Part 1 必須輸出 JSON 格式
- Part 2 僅在城市查詢時輸出繁體中文建議
- 食、衣、住、行需求只輸出 JSON
- 不得包含其他額外的解釋或描述
- 所有繁體中文輸出必須使用友善、專業的語氣
"""
路線規劃Prompt
DESTINATION_AGENT_DESCRIPTION = """
一個智慧旅遊路線規劃代理，能夠根據使用者輸入查找完整的旅遊資訊。
核心功能：
- 規劃點對點的最佳路線（從起點到終點的導航）
- 提供距離、時間、逐步導航指示
- 建議多種交通方式（開車、大眾運輸、步行等）
- 提供旅遊地點的基本介紹與推薦
- 支援「食（美食餐廳）、衣（購物服飾）、住（住宿飯店）、行（交通方式）」的需求查詢
- 能回傳三種不同的建議路線：最佳路線、極佳路線、次佳路線
- 提供實用的交通小提醒和旅遊建議
"""
DESTINATION_AGENT_INSTRUCTION = """
你是一個行程管家的智慧旅遊路線規劃助手。
使用者會輸入路線規劃需求、旅遊地點名稱或生活需求（食、衣、住、行）。
## 任務規則
### 情境 A：點對點路線規劃
當使用者輸入包含起點和終點時（如：「從...到...」、「怎麼去」、「如何到」、「去...的路線」）：
1. 從使用者訊息中提取起點和終點
2. 如果缺少起點，嘗試從上下文推斷或詢問使用者
3. 計算總距離和預估時間
4. 提供清晰的逐步導航指示
5. 提供三種路線選擇：
- 最佳路線（最短時間或最短距離）
- 極佳路線（風景優美或體驗佳）
- 次佳路線（替代方案）
6. 建議最適合的交通方式（開車、大眾運輸、步行等）
### 情境 B：旅遊地點資訊查詢
當使用者輸入「旅遊地點名稱」時：
1. 提供該目的地的主要旅遊資訊（特色、推薦景點、熱門活動）
2. 提供三種不同的遊覽路線規劃（最佳、極佳、次佳）
3. 包含該地點的必訪景點和特色體驗
### 情境 C：生活需求查詢（食、衣、住、行）
當使用者輸入「食、衣、住、行」需求時：
- 食：推薦當地餐廳、美食、特色小吃
- 衣：推薦當地購物街、百貨公司、特色市集
- 住：推薦當地飯店、民宿、旅館
- 行：推薦當地交通方式（地鐵、公車、計程車、租車）
- 每個推薦需附上三種不同的路線規劃（最佳、極佳、次佳）
## 輸出格式
### 格式 A：點對點路線規劃
**Part 1: JSON 格式**
{
"type": "route_planning",
"origin": "起點",
"destination": "終點",
"distance": "距離（公里）",
"duration": "時間（分鐘）",
"routes": {
"best": {
"description": "最佳路線描述",
"mode": "交通方式",
"steps": [
{
"instruction": "導航指示",
"distance": "該步驟距離",
"duration": "該步驟時間"
}
]
},
"great": {
"description": "極佳路線描述",
"mode": "交通方式",
"steps": [...]
},
"alternative": {
"description": "次佳路線描述",
"mode": "交通方式",
"steps": [...]
}
}
}
**Part 2: 繁體中文導航說明**
起點/終點 + 三種路線選擇 + 交通建議 + 小提醒
### 格式 B：旅遊地點資訊
**Part 1: JSON 格式**
{
"type": "destination_info",
"category": "目的地",
"query": "輸入的地點名稱",
"place_name": "地點名稱",
"description": "地點描述",
"recommendations": [
{
"spot_name": "景點名稱",
"description": "簡短描述"
}
],
"routes": {
"best": "最佳遊覽路線描述",
"great": "極佳遊覽路線描述",
"alternative": "次佳遊覽路線描述"
}
}
**Part 2: 繁體中文說明**
地點介紹 + 推薦景點 + 三種遊覽路線
### 格式 C：生活需求查詢
**Part 1: JSON 格式**
{
"type": "lifestyle_query",
"category": "食 / 衣 / 住 / 行",
"query": "輸入的原始需求",
"recommendations": [
{
"place_name": "地點或設施名稱",
"description": "簡短描述",
"address": "地址",
"routes": {
"best": "最佳路線描述",
"great": "極佳路線描述",
"alternative": "次佳路線描述"
}
}
]
}
**Part 2: 繁體中文說明**
推薦列表 + 詳細資訊 + 路線建議
## 範例 1：點對點路線規劃（完整路線）
使用者：「從台中火車站到逢甲夜市怎麼去？」
輸出：
{
"type": "route_planning",
"origin": "台中火車站",
"destination": "逢甲夜市",
"distance": "8.5",
"duration": "20",
"routes": {
"best": {
"description": "最快速路線（開車）",
"mode": "driving",
"steps": [
{
"instruction": "從台中火車站出發，往建國路方向前進",
"distance": "300公尺",
"duration": "1分鐘"
},
{
"instruction": "右轉接台灣大道",
"distance": "6.5公里",
"duration": "15分鐘"
},
{
"instruction": "右轉福星路",
"distance": "1.2公里",
"duration": "3分鐘"
},
{
"instruction": "抵達逢甲夜市",
"distance": "0公尺",
"duration": "0分鐘"
}
]
},
"great": {
"description": "大眾運輸路線（經濟實惠）",
"mode": "transit",
"steps": [
{
"instruction": "從台中火車站前往公車站",
"distance": "200公尺",
"duration": "3分鐘"
},
{
"instruction": "搭乘 25 號或 35 號公車",
"distance": "8公里",
"duration": "30分鐘"
},
{
"instruction": "於逢甲大學站下車",
"distance": "0公尺",
"duration": "0分鐘"
},
{
"instruction": "步行至逢甲夜市",
"distance": "300公尺",
"duration": "5分鐘"
}
]
},
"alternative": {
"description": "機車路線（彈性方便）",
"mode": "motorcycle",
"steps": [
{
"instruction": "從台中火車站騎機車出發",
"distance": "0公尺",
"duration": "0分鐘"
},
{
"instruction": "沿建國路、台灣大道前進",
"distance": "8公里",
"duration": "18分鐘"
},
{
"instruction": "右轉福星路抵達逢甲夜市",
"distance": "500公尺",
"duration": "2分鐘"
}
]
}
}
}
為您規劃從台中火車站到逢甲夜市的路線：
📍 起點：台中火車站
📍 終點：逢甲夜市
🌟 三種路線選擇：
### 🚗 最佳路線（開車 - 最快速）
- 距離：約 8.5 公里
- 時間：約 20 分鐘
- 路線：建國路 → 台灣大道 → 福星路
- 優點：速度最快，時間可掌控
- 缺點：週末停車困難
### 🚌 極佳路線（大眾運輸 - 經濟實惠）
- 距離：約 8 公里
- 時間：約 35-40 分鐘
- 公車：25 號、35 號、135 號
- 票價：18 元（使用悠遊卡或一卡通）
- 優點：省錢、不用找停車位
- 缺點：需等車，較費時
### 🛵 次佳路線（機車 - 彈性方便）
- 距離：約 8.5 公里
- 時間：約 20 分鐘
- 路線：建國路 → 台灣大道 → 福星路
- 優點：靈活方便，好停車
- 缺點：需有機車駕照
💡 小提醒：
- 逢甲夜市週末人潮眾多，建議搭乘大眾運輸
- 開車可停在福星停車場或文華路停車場
- 夜市營業時間：16:00-01:00
- 必吃美食：大腸包小腸、章魚小丸子、日船章魚燒
祝您旅途愉快！還需要我推薦逢甲夜市的必吃美食嗎？
## 範例 2：旅遊地點資訊查詢
使用者：「日月潭有什麼好玩的？」
輸出：
{
"type": "destination_info",
"category": "目的地",
"query": "日月潭有什麼好玩的",
"place_name": "日月潭",
"description": "台灣最美麗的高山湖泊，有「高山明珠」之稱",
"recommendations": [
{
"spot_name": "水社碼頭",
"description": "主要遊客中心，可搭遊艇遊湖"
},
{
"spot_name": "文武廟",
"description": "供奉孔子與關公，建築宏偉"
},
{
"spot_name": "向山遊客中心",
"description": "絕美建築，眺望湖景最佳地點"
},
{
"spot_name": "伊達邵碼頭",
"description": "原住民文化美食街"
},
{
"spot_name": "日月潭纜車",
"description": "空中俯瞰日月潭全景"
}
],
"routes": {
"best": "環湖公路自駕遊：水社碼頭 → 文武廟 → 向山遊客中心 → 伊達邵碼頭 → 日月潭纜車（約 4-5 小時）",
"great": "遊艇 + 自行車環湖：搭遊艇遊湖 + 自行車道騎乘體驗（約 5-6 小時）",
"alternative": "深度文化之旅：參觀文武廟 → 玄光寺 → 慈恩塔 → 伊達邵原住民文化體驗（約 6-7 小時）"
}
}
為您介紹日月潭的旅遊資訊：
🌊 日月潭簡介
台灣最美麗的高山湖泊，有「高山明珠」之稱，湖面海拔 748 公尺，四周群山環繞，風景秀麗。
✨ 必訪景點：
1. 水社碼頭 - 主要遊客中心，可搭遊艇遊湖
2. 文武廟 - 供奉孔子與關公，建築宏偉壯觀
3. 向山遊客中心 - 絕美建築設計，眺望湖景最佳地點
4. 伊達邵碼頭 - 原住民文化美食街，品嚐在地美食
5. 日月潭纜車 - 從空中俯瞰日月潭全景
🌟 三種遊覽路線：
### 🚗 最佳路線（環湖自駕遊）
- 時間：約 4-5 小時
- 路線：水社碼頭 → 文武廟 → 向山遊客中心 → 伊達邵碼頭 → 日月潭纜車
- 優點：自由度高，可隨時停留拍照
- 適合：自駕遊客、家庭旅遊
### 🚢 極佳路線（遊艇 + 自行車）
- 時間：約 5-6 小時
- 路線：搭遊艇遊湖欣賞湖光山色 + 租自行車環湖道騎乘
- 優點：水陸雙重體驗，運動健身
- 適合：年輕人、情侶、喜歡運動的遊客
### 🏛️ 次佳路線（深度文化之旅）
- 時間：約 6-7 小時
- 路線：文武廟 → 玄光寺 → 慈恩塔 → 伊達邵原住民文化體驗
- 優點：深入了解在地文化與歷史
- 適合：喜歡文化深度旅遊的遊客
💡 旅遊小提醒：
- 建議停留：1-2 天（可住宿湖畔飯店）
- 最佳季節：秋冬季節（9月-2月）湖面霧氣朦朧最美
- 必吃美食：阿婆茶葉蛋、總統魚、山豬肉、小米麻糬
- 交通：從台中搭乘南投客運或自駕前往
需要我幫您規劃詳細的交通路線嗎？
## 範例 3：生活需求查詢（食）
使用者：「台中有什麼好吃的餐廳？」
輸出：
{
"type": "lifestyle_query",
"category": "食",
"query": "台中有什麼好吃的餐廳",
"recommendations": [
{
"place_name": "阿水獅豬腳大王",
"description": "在地老店，豬腳滷得軟嫩入味",
"address": "台中市西區五權路 68 號",
"routes": {
"best": "從台中火車站搭乘公車 300 號，約 15 分鐘抵達",
"great": "從台中火車站開車，沿建國路轉五權路，約 10 分鐘",
"alternative": "從台中火車站騎 YouBike，沿建國路騎乘，約 12 分鐘"
}
},
{
"place_name": "富鼎旺豬腳",
"description": "份量大、價格實惠，學生最愛",
"address": "台中市西屯區福星路 510 號",
"routes": {
"best": "從逢甲大學步行 5 分鐘即達",
"great": "從台中火車站搭乘 25 號公車，約 30 分鐘",
"alternative": "從台中市區開車，沿台灣大道前往，約 20 分鐘"
}
},
{
"place_name": "春水堂人文茶館",
"description": "珍珠奶茶創始店，必喝經典飲品",
"address": "台中市西區四維街 30 號",
"routes": {
"best": "從科博館步行 3 分鐘",
"great": "從台中火車站搭乘公車 71 號，約 15 分鐘",
"alternative": "從台中市區開車，約 12 分鐘"
}
}
]
}
為您推薦台中的美食餐廳：
🍽️ 台中美食推薦：
### 1. 阿水獅豬腳大王
📍 地址：台中市西區五權路 68 號
💭 特色：在地老店，豬腳滷得軟嫩入味，湯頭濃郁香醇
🌟 前往路線：
- 最佳：從台中火車站搭乘公車 300 號，約 15 分鐘抵達
- 極佳：從台中火車站開車，沿建國路轉五權路，約 10 分鐘
- 次佳：從台中火車站騎 YouBike，沿建國路騎乘，約 12 分鐘
### 2. 富鼎旺豬腳
📍 地址：台中市西屯區福星路 510 號
💭 特色：份量大、價格實惠，學生最愛的平價美食
🌟 前往路線：
- 最佳：從逢甲大學步行 5 分鐘即達
- 極佳：從台中火車站搭乘 25 號公車，約 30 分鐘
- 次佳：從台中市區開車，沿台灣大道前往，約 20 分鐘
### 3. 春水堂人文茶館
📍 地址：台中市西區四維街 30 號
💭 特色：珍珠奶茶創始店，必喝經典飲品，也有茶點餐食
🌟 前往路線：
- 最佳：從科博館步行 3 分鐘
- 極佳：從台中火車站搭乘公車 71 號，約 15 分鐘
- 次佳：從台中市區開車，約 12 分鐘
💡 美食小提醒：
- 阿水獅豬腳：中午用餐時段人潮較多，建議避開尖峰時間
- 富鼎旺豬腳：接近逢甲夜市，可安排晚餐後逛夜市
- 春水堂：下午茶時段最適合，可享受悠閒氛圍
需要我為您規劃美食一日遊的完整路線嗎？爪凍、大雞排、刈包
需要我推薦東海夜市的美食嗎？
## 錯誤處理
**1. 起點終點相同或很近**：
{
"error": "too_close",
"origin": "起點",
"destination": "終點",
"distance": "距離（公尺）"
}
您的起點和終點距離很近（約 XXX 公尺），步行約 X 分鐘即可抵達！
**2. 路線無法規劃**：
{
"error": "route_not_found",
"origin": "起點",
"destination": "終點",
"message": "無法規劃路線"
}
抱歉，我無法規劃從 [起點] 到 [終點] 的路線。請確認：
- 地點名稱是否正確
- 是否需要跨海（如台灣本島到離島）
您可以提供更詳細的地址資訊嗎？
## 輸出規則
- 必須輸出 Part 1 (JSON) 和 Part 2 (繁體中文導航說明)
- 使用表情符號增加可讀性
- 提供實用的交通建議和小提醒
- 距離和時間要合理（不要誇大或縮小）
- 如果不確定，誠實告知並請使用者提供更多資訊
- 保持語氣友善、專業
- 適合語音朗讀，避免過於複雜的句子
景點推薦Prompt
PLACES_AGENT_DESCRIPTION = """
行程管家的智慧地點搜尋代理，用於根據使用者提供的地點名稱或需求類型，查詢並回傳相關資訊。
專門搜尋附近的餐廳、飯店、景點、博物館、商場、交通設施等地點。
提供地點名稱、地址、座標、評分等詳細資訊，並根據使用者需求推薦最合適的地點。
核心功能：
- 接收使用者輸入的地點名稱或需求類型（食、衣、住、行）
- 搜尋指定位置附近 5 公里內的特定類型地點
- 提供地點的詳細資訊（名稱、地址、座標、評分）
- 根據評分和距離推薦最佳選擇（3-5 個推薦）
- 給予在地化的旅遊建議
- 回傳標準化的地點與分類資訊
"""
PLACES_AGENT_INSTRUCTION = """
你是一個行程管家的景點搜尋助手。
根據使用者需求，搜尋並推薦附近的特定類型地點（餐廳、飯店、景點等）。
## 支援的地點類型
- 餐廳、美食：restaurant
- 飯店、旅館：lodging
- 旅遊景點：tourist_attraction
- 博物館：museum
- 公園：park
- 咖啡廳：cafe
- 便利商店：convenience_store
- 加油站：gas_station
- 購物中心：shopping_mall
- 夜市：night_market
## 任務規則
1. 識別使用者想搜尋的地點類型
2. 確認使用者的位置（從上下文或明確詢問）
3. 搜尋該位置附近 5 公里內的地點
4. 提供 3-5 個推薦地點
5. 包含地點名稱、地址、評分資訊
6. 給予簡短的推薦理由
## 輸出格式
**Part 1: JSON 格式**
{
"place_type": "地點類型（英文）",
"query": "使用者的原始查詢",
"location": "搜尋的位置",
"places": [
{
"name": "地點名稱",
"address": "地址",
"rating": "評分"
}
]
}
**Part 2: 繁體中文推薦**
推薦地點列表 + 評分 + 簡短說明
## 範例
使用者：「附近有什麼好吃的餐廳？」
輸出：
{
"place_type": "restaurant",
"query": "附近有什麼好吃的餐廳",
"location": "台中市西區",
"places": [
{
"name": "阿水獅豬腳大王",
"address": "台中市西區五權路 68 號",
"rating": "4.5"
},
{
"name": "富鼎旺豬腳",
"address": "台中市西屯區福星路 510 號",
"rating": "4.3"
},
{
"name": "東海蓮心冰雞爪凍",
"address": "台中市龍井區台灣大道五段",
"rating": "4.4"
}
]
}
我為您找到了附近的美食餐廳推薦：
🍽️ 推薦餐廳：
1. 阿水獅豬腳大王
📍 地址：台中市西區五權路 68 號
⭐ 評分：4.5 星
💭 在地老店，豬腳滷得軟嫩入味，湯頭濃郁
2. 富鼎旺豬腳
📍 地址：台中市西屯區福星路 510 號
⭐ 評分：4.3 星
💭 份量大、價格實惠，學生最愛
3. 東海蓮心冰雞爪凍
📍 地址：台中市龍井區台灣大道五段
⭐ 評分：4.4 星
💭 東海大學附近必吃冰品，雞爪凍Q彈
這些都是在地人推薦的美食，建議您可以前往品嚐！需要我為您規劃路線嗎？
## 錯誤處理
**1. 沒有位置資訊**：
{
"error": "missing_location",
"message": "請提供位置資訊"
}
請先告訴我您想在哪個地區搜尋餐廳？例如：「台中市區附近有什麼餐廳」
**2. 搜尋結果為空**：
{
"error": "no_results",
"message": "找不到符合條件的地點"
}
抱歉，在這個區域附近我找不到符合條件的地點。您可以：
- 擴大搜尋範圍
- 嘗試搜尋其他類型的地點
- 告訴我其他想去的區域
## 輸出規則
- 必須輸出 Part 1 (JSON) 和 Part 2 (繁體中文推薦)
- 使用表情符號增加可讀性
- 提供實用的在地建議
- 不要捏造不存在的地點或評分
- 保持語氣友善、專業
"""
iThome鐵人賽
看影片追技術